home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / assign.z / assign
Encoding:
Text File  |  1998-10-30  |  3.8 KB  |  92 lines
  1. ASSIGN(3F)                                            Last changed: 2-24-98
  2.  
  3.  
  4. NNAAMMEE
  5.      AASSSSIIGGNN, AASSNNUUNNIITT, AASSNNFFIILLEE, AASSNNRRMM - Provides library interface to aassssiiggnn
  6.      processing
  7.  
  8. SSYYNNOOPPSSIISS
  9.      All systems:
  10.  
  11.      CCAALLLL AASSNNUUNNIITT((_i_u_n_i_t,, _a_s_t_r_i_n_g,, _i_e_r))
  12.  
  13.      CCAALLLL AASSNNFFIILLEE((_f_n_a_m_e,, _a_s_t_r_i_n_g,, _i_e_r))
  14.  
  15.      CCAALLLL AASSNNRRMM((_i_e_r))
  16.  
  17.      CCAALLLL AASSSSIIGGNN((_c_m_d ,,_i_e_r))
  18.  
  19.      UNICOS and UNICOS/mk systems only:
  20.  
  21.      CCAALLLL AASSSSIIGGNN((_c_m_d))
  22.  
  23. IIMMPPLLEEMMEENNTTAATTIIOONN
  24.      UNICOS, UNICOS/mk and IRIX systems
  25.  
  26. DDEESSCCRRIIPPTTIIOONN
  27.      This routine is supported on IRIX systems for programs compiled with
  28.      the MIPSpro 7 Fortran 90 compiler or compiled with the --ccrraayylliibbss
  29.      option to the MIPSpro 7.2 F77 compiler.
  30.  
  31.      AASSSSIIGGNN provides an interface to aassssiiggnn processing from Fortran.
  32.  
  33.      AASSNNUUNNIITT and AASSNNFFIILLEE assign attributes to units and files,
  34.      respectively.
  35.  
  36.      AASSNNRRMM removes all entries currently in the aassssiiggnn environment.
  37.  
  38.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  39.      UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
  40.      unless documented otherwise.  On UNICOS and UNICOS/mk, default kind is
  41.      KKIINNDD==88 for integer, real, complex, and logical arguments; on IRIX, the
  42.      default kind is KKIINNDD==44.
  43.  
  44.      These routines have the following arguments:
  45.  
  46.      _c_m_d       A Fortran character variable containing a complete aassssiiggnn(1)
  47.                command in the format also acceptable to IISSHHEELLLL(3F).  The --VV
  48.                option cannot be processed by the AASSSSIIGGNN routine.
  49.  
  50.      _i_e_r       An integer variable that is assigned the exit status on
  51.                return.  A 0 indicates normal return; >0 indicates a
  52.                specific error status
  53.  
  54.      _i_u_n_i_t     An integer variable or constant containing the unit number
  55.                to which attributes are assigned.
  56.  
  57.      _a_s_t_r_i_n_g   A Fortran character variable containing any attribute
  58.                options and option values that could be passed to aassssiiggnn(1).
  59.                Control options --II, --OO, and --RR can also be passed.
  60.  
  61.      _f_n_a_m_e     A character variable or constant containing the file name to
  62.                which attributes are assigned.
  63.  
  64. NNOOTTEESS
  65.      Users are encouraged to use the AASSSSIIGGNN library routines rather than
  66.      IISSHHEELLLL((''aassssiiggnn'')), because IISSHHEELLLL(3F) causes vvffoorrkk(2), an eexxeecc(2) of
  67.      sshh(1), another ffoorrkk(2), and another eexxeecc(2) of aassssiiggnn(1).
  68.  
  69. EEXXAAMMPPLLEESS
  70.      Example 1:  The following is equivalent to aassssiiggnn --ss uunnbblloocckkeedd ff::ffiillee
  71.  
  72.           CALL ASSIGN('assign -s unblocked f:file' ,ier)
  73.  
  74.      Example 2:  The following has the same effect as aassssiiggnn --II --nn 22 uu::9999
  75.  
  76.           INTEGER IUN
  77.           IUN = 99
  78.           CALL ASNUNIT(IUN,'-I -n 2',IER)
  79.  
  80.      Example 3:  The following is equivalent to executing aassssiiggnn --ss ttaappee
  81.      uu::11
  82.  
  83.           CALL ASNUNIT(1,' -s tape',IER)
  84.  
  85. SSEEEE AALLSSOO
  86.      AASSNNCCTTLL(3F), AASSNNQQFFIILLEE(3F), AASSNNQQUUNNIITT(3F), IISSHHEELLLL(3F)
  87.  
  88.      aassssiiggnn(1)
  89.  
  90.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication
  91.      SR-2165, for the printed version of this man page.
  92.